home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / modem / hsd115b0.zip / HSDLP.DOC < prev    next >
Text File  |  1994-05-10  |  10KB  |  236 lines
  1.  
  2.                               DLP HS/Link
  3.  
  4.                   Copyright 1993, 1994 Samuel H. Smith
  5.                           All Rights Reserved
  6.  
  7.  
  8.             A version of the HS/Link File Transfer Protocol
  9.                               for use with
  10.                         ProComm Plus for Windows
  11.  
  12.                     (PRELIMINARY APPLICATION NOTES)
  13.  
  14.  
  15. HSLINK.DLP is a special version of the HS/Link program which has been written
  16. specifically for use by ProComm Plus for Windows (PROWIN).
  17.  
  18.  
  19.                               INSTALLATION
  20.  
  21. Simply place the HSLINK.DLP in your PROWIN directory, and the HSLINK protocol
  22. will automatically appear in the protocol menus and will work as other
  23. protocols do in this environment.
  24.  
  25. If you wish to include HS/Link in your "host mode" operations, copy the
  26. supplied HOST.WAS file to your PROWIN\ASPECT directory.
  27.  
  28.  
  29.                                OPERATION
  30.  
  31. Once HSLINK.DLP is installed in your PROWIN directory, the HS/Link protocol
  32. will automatically appear in PROWIN's protocol menus.
  33.  
  34. Downloads are automatic and require no special attention.
  35.  
  36. To upload, click the "upload" icon and select files to transmit.
  37.  
  38.                            *** IMPORTANT ***
  39.           To perform a bidirectional transfer, note that you
  40.           MUST NOT press the final <ENTER> key required by the
  41.           BBS you are calling.  Instead, click the "upload"
  42.           icon and flag outgoing files.  When HSLINK starts on
  43.           your end, it will send the final <ENTER> key
  44.           sequence to the BBS.
  45.  
  46.  
  47.                              CONFIGURATION
  48.  
  49. If you wish to set HS/Link options, you can modify the HSLINK.INI file in
  50. your PROWIN directory.  These settings are normally manipulated via the
  51. "Advanced!" setup option of HS/Link from within PROWIN.
  52.  
  53. To configure HSLINK.DLP, activate ProComm+ "Current Setup" ICON, then
  54. highlight the button "Protocol: hslink.dlp" and click "Advanced!".
  55.  
  56. Crash Recovery settings
  57.         Off
  58.                 Disable crash recovery.  Do not allow received files to
  59.                 overwrite existing files.  Partial files from aborted
  60.                 transfers are automatically erased.
  61.  
  62.         Full Recovery
  63.                 Enable full crash recovery.  This option causes partial
  64.                 files from aborted transfers to be retained.  If a
  65.                 received file matches the filename of an existing file,
  66.                 the contents of the file is compared to the received
  67.                 file, and only those blocks which differ are
  68.                 transferred.
  69.  
  70.         Overwrite
  71.                 Disable crash recovery.  Allow received files to
  72.                 overwrite existing files.  Partial files from aborted
  73.                 transfers are retained.
  74.  
  75.  
  76. Block Size settings
  77.         256     Each block will be 265 bytes in length
  78.         1k      Each block will be 1024 bytes in length
  79.         2k      Each block will be 2048 bytes in length
  80.         4k      Each block will be 4096 bytes in length
  81.  
  82. Acknowledge Window Settings
  83.         Full streaming (none)
  84.                 In this mode of operation, blocks are transmitted
  85.                 continuously with no acknowledgement of receipt.  This
  86.                 mode of operation is useful when error correcting modems
  87.                 are used or when flow control is not required.
  88.  
  89.         8 blocks (normal)
  90.                 In this mode of operation, up to 8 blocks may be in
  91.                 transit before an acknowledgement of receipt is
  92.                 required.  Once acknowledgement is received, the next
  93.                 block will be transmitted.  This acknowledgement process
  94.                 provides a form of flow control which is useful when
  95.                 other forms of flow control are not totally reliable.
  96.  
  97.         4 blocks (PC Pursuit)
  98.                 When operating HSLINK on a PC Pursuit connection, I
  99.                 recommend the settings of Ack Window = 4, Block size =
  100.                 256, Xon/Xoff = ON, Minimal Blocks = OFF.
  101.  
  102. File Settings
  103.         Transfer Log File:
  104.                 This defines the DSZLOG-style transfer result log
  105.                 filename.  If left blank, the DSZLOG environment
  106.                 variable specifies this filename.  If no DSZLOG
  107.                 environment setting exists, no logfile will be produced.
  108.  
  109.         Error Log File:
  110.                 This defines the filename for a detailed transfer and
  111.                 error log to be created.  If left blank, the HSERR
  112.                 environment variable specifies this filename.  If no
  113.                 HSERR environment setting exists, no logfile will be
  114.                 produced.
  115.  
  116.         Duplicate Checklist:
  117.                 This defines the filename of a duplication checklist
  118.                 file.  The duplication checklist file can contain a list
  119.                 of directories or filenames to check for duplication.
  120.                 If an incoming file matches a filename or a file in a
  121.                 directory listed here, the file will be rejected.
  122.                 NOTE: duplication checking is active ONLY when Crash
  123.                 Recovery is set to "OFF".  Other crash recovery modes
  124.                 grant HSLINK permission to modify existing files, making
  125.                 a duplication checklist meaningless.
  126.  
  127. Other Options
  128.         Original File Time Stamp
  129.                 Checking this option causes the original file's time and
  130.                 date to be preserved.  Unchecking the option causes the
  131.                 current time and date to be given to a file when it is
  132.                 received.
  133.  
  134.         Minimal Blocks
  135.                 Checking this option causes HSLINK to minimize each
  136.                 block transmitted, resulting in an increase in thruput.
  137.                 Unchecking this option causes HSLINK to include
  138.                 additional information in each block as required by PC
  139.                 Pursuit or some other environments.
  140.  
  141.         File Buffering
  142.                 Checking this option causes HSLINK to use a 10k buffer
  143.                 for files being received or transmitted.  Unchecking
  144.                 this option causes HSLINK to read or write each file
  145.                 block as it is sent or received.
  146.  
  147.         Large Status Display
  148.                 Checking this option causes a larger file transfer
  149.                 status display to be used.
  150.  
  151.         XON/XOFF Handshake
  152.                 Checking this option indicates that you desire to use
  153.                 the XON/XOFF software handshake.  Unchecking this option
  154.                 indicates that you do not desire this handshake, but
  155.                 that you will still use it if the remote unit desires
  156.                 its use.
  157.  
  158.         Force Remote to use Local Settings
  159.                 Checking this option causes forces the remote unit to
  160.                 use your settings for Minimal Blocks, Block Size, Ack
  161.                 Window and Xon/Xoff.  Unchecking this option allows the
  162.                 remote unit to override your settings, or causes
  163.                 compromise settings to be negotiated according to both
  164.                 local and remote options.
  165.  
  166.         Allow Bidirectional Transfers
  167.                 Checking this option allows files to be received while
  168.                 files are being transmitted.  Unchecking this option
  169.                 causes HSLINK to reject any incoming files when files
  170.                 are being transmitted.
  171.  
  172.         Beeper in Chat Mode
  173.                 Checking this option allows the remote unit to beep your
  174.                 speaker with the "page remote" or ^G key in CHAT mode.
  175.                 Unchecking this option forces your speaker to remain
  176.                 silent at all times.
  177.  
  178.  
  179. Controls
  180.         OK
  181.                 This causes current settings to be saved.
  182.  
  183.         Cancel
  184.                 This causes changes in settings to be discarded and
  185.                 previous settings to remian in effect.
  186.  
  187.         Use Default
  188.                 This resets all settings to their original default
  189.                 values, which should work properly in most
  190.                 circumstances.
  191.  
  192.         Register...
  193.                 This allows you to enter your personal registration code
  194.                 as well as your name and company name.
  195.  
  196.  
  197.  
  198.                               DIFFERENCES
  199.  
  200. HSLINK.DLP is similar to the standard DOS HSLINK with the following
  201. exceptions:
  202.  
  203. *  GIF files are automatically displayed onscreen during file transfer.
  204.  
  205. *  The command line is automatically provided by PROWIN.  Modify the
  206.    HSLINK.INI file provide protocol options.
  207.  
  208. *  The "REGISTER" screen now accepts DLP HS/Link activation codes.
  209.    Sorry, but DOS HS/Link registrations are not valid for the Windows
  210.    DLP version.
  211.  
  212.  
  213.  
  214.               !!!!!!!!!!!!!! BETA TEST VERSION !!!!!!!!!!!!!!!!
  215.      This version may seem to work, but it has not been fully tested and
  216.               is not an official release!  You have been warned.
  217.            PLEASE MAKE FREQUENT BACKUP COPIES OF ALL CRITICAL FILES
  218.               !!!!!!!!!!!!!! BETA TEST VERSION !!!!!!!!!!!!!!!!
  219.  
  220.     Beta Testing is a means of getting widespread exposure to unfinished
  221.     versions of a program during the development process.  The idea is for as
  222.     many users as possible to "beta test" the program and to make suggestions
  223.     and report bugs.  This type of widespread testing can lead to a very
  224.     stable and bug-free finished product (the RELEASE version). Please read
  225.     HSLINK.NEW to see what has been changed recently.
  226.  
  227.     If you encounter problems or would like to make a suggestion, please
  228.     contact the author. HS/Link product support is available by VOICE at
  229.     (213) 851-9969 between 9am and 6pm pacific time, TUESDAY through
  230.     SATURDAY.
  231.  
  232.     To obtain newer beta test versions, please call (213) 851-2127 and select
  233.     the "free downloading" service from the initial "special services menu".
  234.     You need not be a registered Tool Shop BBS user to access this special
  235.     service.
  236.